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1. OVERVIEW

IBM OS/2 support for the Intel PRO/1000 Family of Adapters, both Copper
and Fiber media includes the following hardware controllers:

   Intel 82540EM controller based Copper Gigabit Ethernet Adapters
   Intel 82540EP controller based Copper Gigabit Ethernet Adapters
   Intel 82541EI controller based Copper Gigabit Ethernet Adapters
   Intel 82541GI controller based Copper Gigabit Ethernet Adapters
   Intel 82544EI controller based Copper Gigabit Ethernet Adapters
   Intel 82544GC controller based Copper Gigabit Ethernet Adapters
   Intel 82543GC controller based Copper Gigabit Ethernet Adapters
   Intel 82543GC controller based Fiber Gigabit Ethernet Adapters

This software update provides the latest device driver for OS/2
Warp 4 and OS/2 Warp Server for e-business.

The self-extracting package contains following files :
    README.TXT  - This File
    IBMGU.OS2   - OS/2 Device Driver
    IBMGU.NIF   - Network Information File
    IBMGU.SYM   - Debug Symbol File


2. INSTALLATION

Extract the IBMGU.EXE package contents to a directory (existing or new)
or to a diskette.

The method used to install the IBMGU driver depends on the
version of OS/2 installed on your system, i.e., Warp Server for
e-business or OS/2 Warp 4.


To install the IBMGU driver on Warp Server for e-business, use
the following procedure:

1) From your boot partition, open an OS/2 Command prompt window.
2) Change to the \IBMLAN\INSTALL subdirectory.
    >cd \ibmlan\install
3) Run the install program LANINST.EXE.
    >laninst.exe
4) Select 'OK' on the 'IBM Welcome ...' panel.
   The 'Easy or Tailored Installation/Configuration' panel is displayed.
5) Select 'Tailored'.
   The 'Installation Task' panel is displayed.
6) Select the 'Install or configure this workstation' option.
   The 'Installation Location' panel is displayed.
7) Select 'OK'.
   The 'Server Type' panel is displayed.
8) Select 'OK'.
    A 'Later MPTS Version Installed' message panel is displayed.
9) Select 'OK'.
   The 'Network Adapters' panel is displayed.  An 'Unknown'
   adapter may show in the list.
10) Select 'OK'.
    The 'Adapter and Protocol Configuration' panel is  displayed.
11) Select 'Other adapters...'.
    The 'Copy Additional Network Adapter Drivers' panel is displayed.
12) Insert the diskette containing the drivers for the IBMGU adapter
    into drive A:, or specify the path where the driver has been extracted 
    and Select 'OK'. The device drivers will be installed.
    The 'Adapter and Protocol Configuration' panel is redisplayed.
13) Select 'IBM Gigabit Ethernet Adapter (OS/2)' from the
    Network Adapters list. Then Select 'Add'.
14) Add the desired protocols to the IBMGU adapter.
15) Select 'OK' on the 'Adapter and Protocol Configuration' panel.
    The 'Remote IPL Requirement' panel may be displayed. If it is,
    select 'Yes' to continue. The 'Installation and Configuration'
    panel is redisplayed.
16) Select 'Configure a Component'.  Then select 'OK'.
    The 'Configure' panel is displayed.
17) Configure 'LAN Services Adapter' (the defaults are usually okay).
18) Configure 'First Failure Support Technology/2' (the defaults are
    usually okay).
19) Select 'OK' on the 'Configure' panel.
    The 'Installation and Configuration' panel is redisplayed.
20) Select 'Apply the changes'. Then select 'OK'.
21) Select 'OK' for the 'LAN Software is Running' message.
    The program CD will be needed to complete this step. Insert
    the CD when prompted. The 'File Backup' panel is displayed.
22) Select 'OK'.
23) Wait for the 'Installation/Configuration Complete' panel.
    Select 'OK'.
23) Shutdown and reboot the system.

    For OS/2 Warp 4 clients, there are two install possibilities:
    1) when the 'File and Print Client' is installed and  2) when
    the 'File and Print Client' is not installed.

    Use the following procedure when the 'File and Print client'
    is installed:

1) From your boot partition, open an OS/2 Command prompt window.
2) Change to the \IBMLAN\INSTALL subdirectory.
     >cd \ibmlan\install
3) Run the install program LANINST.EXE.
     >laninst.exe
4) Select 'OK' on the 'IBM Welcome ...' panel.
   The 'Easy or Tailored Installation/Configuration' panel is displayed.
5) Select 'Tailored'.
   The 'Installation Task' panel is displayed.
6) Select the 'Configure this workstation' option.
   The 'Hard Disk' panel is displayed.
7) Select 'OK'.
   A 'Later MPTS Version Installed' message panel is displayed.
8) Select 'OK'.
   The 'Network Adapters' panel is displayed.  An 'Unknown' adapter
   may show in the list.
9) Select 'OK'.
   The 'Adapter and Protocol Configuration' panel is displayed.
10) Select 'Other adapters...'.
    The 'Copy Additional Network Adapter Drivers' panel is displayed.
11) Insert the diskette containing the drivers for the IBMGU adapter
    into drive A:, or specify the path where the driver has been extracted 
    and Select 'OK'. The device drivers will be installed.
    The 'Adapter and Protocol Configuration' panel is redisplayed.
12) Select 'IBM Gigabit Ethernet Adapter (OS/2)' from
    the Network Adapters list. Then Select 'Add'.
13) Add the desired protocols to the IBMGU adapter.
14) Select 'OK' on the 'Adapter and Protocol Configuration' panel.
    The 'Installation and Configuration' panel is redisplayed.
15) Select 'Configure a Component'.  Then select 'OK'.
    The 'Configure' panel is displayed.
16) Configure 'LAN Services Adapter' (the defaults are usually okay).
17) Configure 'First Failure Support Technology/2' (the defaults are
    usually okay).
18) Select 'OK' on the 'Configure' panel.
    The 'Installation and Configuration' panel is redisplayed.
19) Select 'Apply the changes'. Then select 'OK'.
20) Select 'OK' for the 'LAN Software is Running' message.
    The program CD will be needed to complete this step.
    Insert the CD when prompted. The 'File Backup' panel is displayed.
21) Select 'OK'.
22) Wait for the 'Installation/Configuration Complete' panel.
    Select 'OK'.
23) Shutdown and reboot the system.

For OS/2 Warp 4 clients that do not have the 'File and Print
client' installed, use the following procedure:

    1) Open an OS/2 command prompt (windowed or full screen)
    2) Type 'MPTS', and hit Enter.
    3) Select 'Install', and enter the path where the drivers have 
       been extracted
    4) Select 'OK', system will install the drivers and give a notification
       that network driver was successfully installed

    Configuration Steps:

    1) From MPTS select 'Configure'
    2) Find the "IBM Gigabit Ethernet Adapter (OS/2)" driver in the Network 
       Adapter list and select 'Add'
    3) Select the TCP/IP protocol, and select 'Add'
    4) Select the NETBIOS protocol, and select 'Add'
    5) Select OK
    6) Select 'Exit' MPTS.
    7) Shutdown and reboot the system.

NOTE : See section 4.2 for NetBIOS limitations


3. DRIVER PARAMETERS

    The IBMGU driver will support TCP/IP, TCPBEUI, and NETBEUI
    only. See section 4.2 for NetBIOS limitations.

    The number of Transmit and Receive Buffers and the size of
    these buffers can be modified. The default number of Transmit
    and Receive Buffers is 64. Gigabit Ethernet supports buffer 
    sizes up to 16384 bytes long. 8192 is the default value. 
    The MTU size range is 1500 to 16100 bytes. For MTU size 
    changes use the TCP/IP setup program.

    If more than one Gigabit Ethernet Adapter is used then
    'Slot/Device Identifier' must be specified for each card.
    Initially leave these fields empty and write down the
    detected slot values which are displayed during the boot
    process.  Use these values detected to fill in  'Slot/Device
    Identifier' field for each card and then reboot the computer.

    The EEPROM MAC address of network card can be overridden by
    specifying the different address in 'Locally Administered
    Address' field.

    There are no command line switches.


4. RESTRICTIONS

 a) Wiring for Copper Gigabit Adapters 
    Wiring Gigabit must use at least CAT-5E or a known CAT-5 wiring scheme
    where all 8 wires are used and attached to the connectors.
    Failure to use this wiring scheme will result in speeds
    below 1 Gb, as the adapter will not negotiate 1Gb without
    CAT-5E wiring.  Failure to use CAT-5E may also result in lost
    connections or buffer overruns.

 b) NetBIOS limitations
    NetBIOS must use DIX 2.0 mode - the protocol type ETHERAND_TYPE 
    should be set to "D".

    1) From MPTS select 'Configure'
    2) In 'Current Configuration' find the "IBM OS/2 NETBIOS" and
       press 'Edit'
    3) Set 'Type of Ethernet driver support' = "D"
    4) Select OK
    5) Select 'Exit' MPTS.

 c) Enforced Speed/Duplex Settings
    If the link partner uses enforced speed/duplex settings, only half duplex
    mode will be supported for 10/100 Mbps networks in auto-negotiation mode.
    This is a limitation of Ethernet specification. To use the full duplex
    mode the user should manually force speed and duplex settings. See section
    5. for more details.


5. FORCING LINK PARAMETERS

By default the IBMGU driver operates in auto-negotiation mode, where all link
parameters are automatically negotiated with the link partner. Sometimes
hardware incompatibility or limitations imposed by Ethernet specification may
require the ability to manually enforce the link parameters.

There are four parameters which can be changed in MPTS:

 a) SPEED - Link speed
    Allows to specify link speed in Mbits/sec. Possible values are 10, 100 and
    1000 Mbits/sec. For default auto-negotiated speed leave the field empty or
    specify 0. If speed is enforced, then duplex mode must be forced too.
    Although Ethernet specification for 1000 Mbit/sec speed always requires
    the auto-negotiation mode, the manually enforced parameters work fine and
    sometimes might be helpful to workaround hardware compatibility issues.
    For 1000 Mbit/sec only full duplex mode is supported.

 b) DUPLEX - Duplex settings
    Allows to specify the link duplex mode. Possible values are 1 for half
    duplex and 2 for duplex. For default auto-negotiated duplex mode leave the
    field empty or specify 0. If duplex mode is enforced, the speed must be
    forced too. For 1000 Mbit/sec speed only full duplex mode is supported.

 c) CROSSOVER - Cable crossover
    The network card is able to automatically detect whether you are using
    standard straight wire cables or special cross-link cables for direct
    back-to-back connection. It has been observed that in some situations the
    cable type was incorrectly identified and that prevented the establishment of
    the link. To avoid the wrong identification, the user can enforce cable type.
    The possible values are 1 for MDI (standard straight wire cable) and 2 for
    MDI-X (cross-link cable). For default auto-detection, leave the field empty
    or specify 0.
    As a general rule when connecting to hubs/switches use standard MDI cables
    and for direct connection between two machines use cross-link cables. If two
    machines are directly connected with a cross-link cable, the CROSSOVER value
    should be the same at both ends. If a straight thru cable is used for direct
    connection between two machines, then one end should use MDI and other end 
    use MDI-X.
    Only CAT-5E or better cables should be used.

 d) MASTER - Master/Slave resolution
    All Ethernet connections are between two nodes. One of them serves as a
    master and other as a slave. Normally these roles are assigned during the 
    auto-negotiation process. But in some rare conditions the hardware
    incompatibility may cause the link to work unreliably if master/slave 
    settings are not set to specific values.
    The possible values are 1 for master and 2 for slave. For default auto
    detection leave the field empty or specify 0.
    As a general rule a hub/switch serves as the master and individual workstations 
    serve as the slaves. For direct computer-to-computer connections you should
    select which one will be the master and which one will be the slave. For forced
    1000 Mbit/sec mode you must specify master/slave for both link partners.


6. PERFORMANCE TUNING FOR TCP/IP

Gigabit Ethernet networks have a huge potential for high speed data
transfer, but to achieve maximum throughput some additional parameter
setup might be required. Here are some recommendations:
 a) Gigabit Ethernet is very I/O intensive, and requires systems in the
    network to have enough CPU power. If the CPU utilization  during
    data transfer is consistently around 100%, a more powerful CPU
    may be required.
 b) Larger frame sizes usually improve network throughput. Larger frames
    can improve transfer speed for very large continuous data streams.
    For small data packets, the transport overhead may be too large and
    could decrease the transfer speed. Frame sizes of 8192 bytes would be
    a good initial evaluation value.
 c) The number of transmit and receive buffers can impact transfer speed.
    For network connections with long segments, an increase in the number
    of buffers should increase the overall transfer speed. For short network
    segments, smaller number of buffers can improve the transfer speed.
    A good initial evaluation value for the number of transmit and receive
    buffers is 32.
 d) Larger MTU values will increase data throughput. An MTU of 4096 bytes
    would be a good initial evaluation value.
 e) Specific applications may have an impact on the overall network 
    performance. In some cases, the network driver settings that are 
    optimal for one application may not be optimal for another. If possible 
    try different programs (e.g. FTP clients) to determine the most 
    effective settings and tune the networking parameters for application 
    that will benefit most from the increased data transfer speed.
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